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PREFACE 


This manual gives instructions on how to interface with the Series 60 Level 64 
Communications Processing Facility. 


The physical operation of a terminal is not described except where relevant to a 
discussion of operator interaction with the system. For the operating instructions 
and complete physical description of a supported device, consult the manufacturer. 


Section I gives a glossary of telecommunications terms and describes the concept 
of a terminal as seen by Level 64. Section II lists the terminals supported and 
describes their general characteristics. Section III describes the procedures 

for establishing a connection between a terminal and an application. Section IV 
contains a complete description of tne set of commands available to the terminal 
operator through Level 64. Section V lists and describes the messages that can be 
sent from the system to the terminal. 


Each section of this document is structured according to the heading hierarchy 
shown below. Each heading indicates the relative level of the text which follows 
Le. 


Level Heading Format 
1 (highest) ALL CAPITAL LETTERS, UNDERLINED 
2 Initial Capital Letters, Underlined 
a ALL CAPITAL LETTERS, NOT UNDERLINED 
4 Initial Capital Letters, Not Underlined 
5 (lowest) ALL CAPITAL LETTERS FOLLOWED BY COLON: 


Text begins on same line. 
The following notation conventions are used in this manual: 
UPPERCASE The keyword item is coded exactly as shown. 


lowercase Indicates a user-supplied parameter value. 


[item] An item within square brackets is optional. 
iteml A column of items within braces means that one value must be selected 
item2 if the associated parameter is specified. If the parameter is not 
item3 | specified. the underlined item is taken as the default value. 

) Parentheses must be coded if they enclose more than one item. 
ane An ellipsis indicates that the preceding item may be repeated one or 


more times. 
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INTRODUCTION 


The objective of telecommunications is to convey information between 
two points. Most often, the two points are a central comouter and a 
remote device, capable of sending and receiving information. 


NOTE? Although a remote device can have several connotations (e.g., 
terminal, station - see below in the glossary), the word 
terminal is all-inclusive as used in this-.manual. 


Each end-point must have a driver. At the computer end, it is the 
software that provides. control and direction’ at the terminal end, 
the terminal operator contributes significantly to the control of 
the flow of the information to and from the terminal. 

This manual provides a description of the role o 
operator in the Level 64 telecommunications environment. This manual 
is not meant to cover the various applications functions (discussed 
in the appropriate manual) but only the ways in. which terminals can 
interact with the system. 


Ff +i nw + awem 
i i 


The rest of this section is dedicated to various concepts to help 
the reader understand the terminology used. 


BINS is software provided to the user to support a communications 
network and forms the case of Level 64 communications. [t is the 
main interface between applications and the terminals. BINS has two 
main components: 


- The Dispatcher: which supervises all physical 1/0 
(input-output) operations over the communications lines. It is 
also responsible for message switching and line selection. 


- The Site Controllers which is in overall charge of the 


communications network, and supervises the following 
activities: 
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- requesting dispatcher functions during message exchanges 
over the lines. 


- establishing and disestablishing sessions (log-<on, 
log-off). 


~ supervising the states of the physical units (terminals, 
lines, etc...). 


~ dynamic reconfiguration of the network. 


~ issuing various informative and error messages. 


MAM AND VCAM SUBSYSTEMS. 


There are two subsystems used in Level 64 communications and these 
are used by the applications as access methods. 


MAM (Message Access Method) is used only with MCS COBOL applications 
and provides the user with access to message queues on disk and in 
main memory. 


VCAM (Virtual Communications Access Method) is used by the direct 
access applications (IOF, ROF and TDS), and permits direct 
communications between the application and the BINS service Job. 


APPLICATIONS 


Applications are user programs in the host computer’s CPU (Central 
Processor Unit). Level 64 supports four types of applications. 


MCS (Message Control System) COBOL applications interact with the 
terminal operator via queues (See below), and use the MAM subsystem 
to permit access to these queues. Due to the queue concept the 
operator is not in direct contact with the applications. 


TDS (Transaction Driven Subsystem) applications are used for real 
time processing. TDS applications interact with the terminal 
operator via the VCAM subsystem. 


IOF (Interactive Operator Facility) applications are service jobs 
which allow the terminal operator to run Jobs on the host computer 
and to access the job outputs on the terminal. IOF interacts via the 
VCAM subsystem. 


ROF (Remote Operations Facility) applications are service Jobs 


whereby two linked computers can exchange data and messages. ROF 
uses the VCAM subsystem. 
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PROGRAM AND TERMINAL QUEUES 


MCS COBOL applications use queues for inputting and outputting data, 
these queues are accessed via MAM. The queue from which the program 
receives data (input) is called the program queue and the queues to 
which the program sends data (outputs) are called the terminal 
queues. 


The program queue receives messages from terminals which are 
logged-on to the program queue. These messages are stored in the 
order in which they were received’ thus when the MCS program 
accesses these messages it will handle them in the same order as 
when they were received. Terminals can still send messages to a 
program queue while the application is not active, providing the 
queue is not disabled. A program queue can be enabled or disabled by 
either the application or the network control operator. 


The terminal queues are used to store messages from the application 
to the terminals ona first in, first out basis. BINS extracts these 
messages and sends them to the destination terminal. Each terminal 
using an MCS application must have a terminal queue defined at 
network generations the queue takes the same name as the terminal. 


re two tynes of lines used in communications noint-to-noint 


Ww YL aed 7 hMY A ad a Stiw a NA ie? NP Pe as we wwe ba a nd 


to ae computer, whereas mUve Tootnt lines can connect several 
stations (clusters of terminals) to the computer. In the second case 
the lines have to be controlled by polling and selecting to govern 
the transmission and destinations of messages over the lines. 


In either of the above cases the lines may be either switched or 
non~switched. A non-switched line is permanently assigned to the 
network and can be considered as part of it, a switched line, 
however, has to have its presence established during the log-on 
procedure as it is not permanently. assigned to the network. (See 
“Manual Log-on", section III). 


NETWORK CONTROL TERMINAL 


Control over the communications network - lines, terminals, queues — 
is exercised by the network control operator. The network control 
terminal is named when the network is generateds it can be any 
terminal in the network or, by default, the system console. Network 
generation is described in the "Communications Processing Facility" 
manual. 
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COMMANDS AND ACTIONS 


Operator actions are sometimes dependent on the type of application 
involved. Where appropriate, operator actions relevant to TDS are 
described. In other cases, the reader is referred to the "TDS Site 
Manual” for a description of operator actions specific to TDS. 


Apart from handling log-on dialogs (see Section III), the site 
controller is also responsible for handling terminal operator 
commands. There are two types of command, standard and privileged. 
Privileged commands can only be entered from the network control 
terminal.(For more information on these commands refer to the 
Network Control Terminal Operations manual.) Standard commands are 
available to both the network control operator and the terminal 
operator, for whom this manual is intended (see Section IV). 


TERMINAL STATES 


After a terminal is turned on, it can be in one of the following 
states? 


-HELD 
-IDLE 
-LOGIN 
= LOGGED 
~ACTIVE 


A terminal can be specified as HELD at network generation. There are 
privileged commands through which the network control operator can 
hold and release terminals: in fact, with these commands lines and 
queues can also be held and released. Some external events, such as 
terminal failure, can also cause a terminal to be held. A held 
terminal is out of use as far as the site controller is concerned 
and thus cannot access or be accessed by an application. The 
terminal operator cannot control the holding or releasing of the 
terminal. 


A terminal is IDLE when it 1s not held and is also eligible to be 
logged-on to an application. 


A terminal is LOGIN while it is in the process of logging-on, i.e., 
between being IDLE and LOGGED. 


A terminal is LOGGED after the log-on procedure is successfully 
completed, but a session is not yet established with an application 
as the application has not yet issued an allocation request for the 
terminal. 
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A terminal is ACTIVE when it has established a session with an 
application. 


TERMINAL CLASSIFICATIONS 


An operator’s actions often depend upon how his terminal is 
classified. Terminals can be classified ast 


-Dedicated 
-General-purpose 
“Master or Slave 


These classifications are described below. 
Dedicated Terminal 


A dedicated terminal can only be in session with a specified 
application. The terminal can be dedicated to an application either 
at network generation or by a privileged network control command 
(see note). A dedicated terminal can be logged-on to its application 
either automatically or manually (see Section III). 


NOTE’ The network control operator can change a dedicated terminal 
to a general-purpose terminal, or vice-versa, by use of the 
privileged command Modify Telecom Terminal (MTT). 


General-purpose Terminal 


A general-purpose terminal can be used for a session with any of the 
applications recognized by BINS. The session is effective until 
terminated by operator or program request. Once this has happened 
the terminal is eligible to be logged-on to another application. A 
general-purpose terminal can be logged-on to an application either 
automatically or manually (see Section III). 


Terminal as Master or Slave 


A terminal cluster or multi-terminal station (such as a VIP7700) can 
be defined with one or several masters for the ther units, or 
slaves, attached to the same station. For example, the 
keyboard/screen can be the master with the printer and cassette unit 
as. slaves. The terminal unit is defined as master or slave at 
network generation. 
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The master/slave concept exists solely as a convenience for 
logging~on. When a master terminal logs~-on to an application, either 
automatically or manually, all the slave terminals attached to the 
Same station are logged-on at the same times a slave terminal cannot 
log-on independently. In addition, if the master is a dedicated 
terminal, all its slaves are dedicated to the same applications’ a 
slave terminal cannot be dedicated independently of its master. 


A master terminal in this sense is not to be mistaken for the 
network control terminal, which oversees all terminals, or for the 
master terminal designated to control a TDS session (see the "TDS 
Site Manual"). 


NOTE: For any of the above classifications (except slave) the 
terminal may also be controlled’ this is specified at network 
generation where the terminal description contains the CONTROL 
option. A controlled terminal has a slightly different log-on 
procedure where certain information has to be supplied before 


a session can be established. See log-on procedures in Section 
III. 
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SECTION II 


TERMINALS SUPPORTED AND THEIR CHARACTERISTICS 


Level 64 supports a variety of terminal types. This section groups 
these terminals and briefly describes some of their functional and 
operational characteristics. The reader is referred to documentation 
supplied by the manufacturer for information regarding the design 
and Operation of a specific device. 


TERMINAL GROUPS SUPPORTED BY LEVEL 64 TELECOMMUNICAT IONS 


Terminals supported by Level 64 are divided into four groups. 
Terminals witnin a group are compatible with each other. 
Compatibility is linked to line procedure, hence each terminal group 
has its own line procedure. The terminal groups and the types of 


communications lines to which they can be attached are listed below. 


Group | - Teletype and related devices (TITY. Line Procedure) 
VIP 7100/7200 
TTY 33/35/37/38 line only 


TWU 1001/1003/1005 
TN300/1200 
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Group 3 -— VIP (VIP Line Procedure) 


VIP 765/ 775/785 point-to-point 

VIP7700/7760/7700R 

TWU 1901 or multipoint 
line 


Group 4 — BSC (BSC Line Procedure) 


HL 61 point-to-point 
HL 62 

HL 64 line only 

HL 66 


NOTES’ Because of Special considerations, the site controller cannot 
communicate with a BTT 7300 or with an HL61],62,64 or 66. Thus, 
information in this manual regarding the log-on procedure, 
operator commands, and messages received at the terminal, does 
not pertain to these devices. 


MESSAGE TERMINATING CHARACTERS 


Each terminal group has a specific way of denoting the end of a 
message being sent from the terminal. 

For teletype~group terminals, message terminating characters are 
entered directly by the terminal operator, who depresses the 
appropriate key. Depending on the device and what has been defined 
to the system, the terminating key can bet CR (Carriage Return), LF 
(Line Feed), NL (New Line), CAN (Cancel), or SUB (Substitute). 


NOTE: A default time delay of 2 minutes is allowed between 
characters being entered. If time elapses before the next 
character is entered, the end-of-message is forced. This value 
can be modified at network generation with the TOLEN parameter 
of the LINE command. It can also be modified by the Network 
Control Operator by the Modify Telecom Line (MTL) command. 


For VIP-group terminals, the ETX and EOT (end-of-transmission) 
characters denote message termination. For certain devices of this 
group, these characters are affixed automatically when the Transmit 
key is depressed. (ther devices of the group are equipped with ETX 
and EOT keys (consult the device manual). 


For BSC-group terminals, message termination is a programming 
consideration. 
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ERASING FUNCTIONS 


The operator must have some means of rectifying incorrectly entered 
information. The means vary depending on the group and the device. 


Teletype-group terminals are not buffered’ i.e., entered characters 
are sent immediately over the line to the central coasuber If an 
erroneous character or line is entered, the terminal operator must 


request that the previous character can be erased by entering a 
backslash (/). The previous line can be erased by entering the #@ 
symbol followed by CR. These functions must be specified for the 
terminal at network generation (ERCAP parameter in the LINE 
command). 


NOTE: The operator must be wary of one instance: if the last 
character of a message is the @ symbol and the CR character is 
the message terminating character, the last line entered is 
inadvertently erased. 


VIP-group terminals are buffered: therefore, all editing and erasing 
functions can be rena Rents eae be fore entering» a transmission | 


For BSC-group terminals, editing functions are under program 
control. 


ERROR DETECTION AND MESSAGE RETRIES 


BINS software and IURP or URP firmware monitor communications 
activity and detect errors. When the error is a hardware problem, 
the affected terminal and line, if applicable, are closed 
automatically. When the problem is corrected the terminal, and 
possibly the line, must be released by the network control operator 
and a new session must also be established before activity between 
the terminal and the application can be resumed. 


When there is an error in transmission (parity error over the line 
or a loss of characters due to line interference), attempts to 
complete the transmission successfully are repeated automatically as 
necessary according to the number of retries called for at network 
generation. If the number specified is exhausted without having 
completed a successful transmission, the terminal and line are 
automatically held before activity can be resumed the terminal and 
line must be released by the network control operator. 
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Error Detection and Operator Intervention 


When a page overflow condition occurs on a VIP 7700 terminal, the 
ERROR light illuminates to notify the operator. This condition can 
be the result of a program error (the message is too long), or an 
operator error (failure to clear the screen). The terminal is 
flagged as busy by BINS so that no further output attempts are made 
to the terminal. Operations can resume only after the operator? (1) 
Clears the screen (as described in the device manual) and (2) sends 
the command RDY (see Section IV). 


The message being sent when the overflow occurred is sent again. If 
the condition is the result of message length, there is a 
recurrence. The operator can dynamically alter the length through 
the Modify Terminal Edit (MTE) command (see Section IV). 


LINE AND MESSAGE LENGTHS 


The maximum line length of a terminal is a hardware characteristic 
as is the maximum message length. Values, up to the maximum, can be 
specified for the line and message lengths of each terminal at 
network generations there is however a maximum message length that 
can be used on a Level 64 network, this is 2,442 characters 
(including control characters). The terminal operator has the 
ability to alter the values of message and line length through use 
of the Modify Terminal Editing (MTE) command (see Section IV). 


The following list shows the maximum line and message lengths for 
the various terminals, however the relevant hardware manual should 
be consulted as some terminals are supplied with more than one 
screen size. 
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Terminal Maximum line Maximum Message 


Length Length 
HL61,62,64,66. * 2048 
TN300 & TN1200 118 120 
TTU8124 & TTU8126 132 256 
TTU8221 132 1920 
TTY33 - TTY38 72 120 
VIP765 & VIP775 46 960 
VIP785 92 1920 
VIP7100 & VIP7200 80 120 
VIP7700, VIP7760 & 7700R 80 1920 


* = not applicable 


new line when necessary? line length for terminals using the 


Lal & Sit batew 


BSC line procedure is under program control. 
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SECTION III 


LOG=ON AND LOG-OFF PROCEDURES 


A connection must be established between a terminal and an 
application before a session can take place. This section descrihes 
how a session is established and terminated by a terminal operator. 


LOG-ON CONSIDERATIONS 


Logging-on is only possible if all the physical and logical 
resources that are required are available. This means that: 
i, The line to which the terminal is connected is 


initialized and is not held. 


2. If the terminal is connected via a station then the 
station must be initialized and must not he held. 


3. The terminal itself is eligible for connection, i.e., in 
the IDLE state. 


4. The supporting software and the intended application or 
program queue are active. 


The initial states of the physical units can be specified at network 
generation, and at the startup of communications (i.e. the 
introduction of a BINS service job) the site controller tries to 
implement the specified network state. At the end of startup 4 list 
of all the units that could not be put into the snecified states is 
displayed on the network control terminal. The site control operator 
can dynamically alter the network configuration by use of privileged 
commands. 


A TDS direct access application must signal its presence to the site 
controller if it is to be considered active. It must then issue 
allocation requests for terminals, otherwise log-on requests for the 
TDS will be denied or enqueued. This is to say that an "M-START" TDS 
command must have been issued by the TDS master terminal. 
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IOF and ROF applications are started automatically by the site 
controller when the appropriate log-on procedure has been 
successful. 


To log-on to an MCS COBOL application the program or terminal queue 
must be enabled (not held), otherwise the log-on request will either 
be denied or enqueued. A queue (program or terminal) can be 
specified as enabled or disabled at network generation. During a 
communications session, queues can be enabled or disabled by either 
the application program or the network control operator. If only the 
program queue is enabled the terminal can only be used for one way 
input: if only the terminal queue is enabled the terminal can be 
used only for one way output. 


There are other considerations that affect logging-on; 


1. Whether the terminal has automatic or manual log-on 
procedures (specified at network generation). 


2. Whether or not the terminal has been dedicated to a 
specific application (can be specified at network 
generation). 


3. Whether or not the terminal is under control (specified 
at network generation). 


Automatic Log-on 


A terminal can be defined as AUTO at network generation. This is 
normally used for receive~only or master terminals. No operator 
intervention is required for session establishment as the site 
controller handles the log-on procedure and also enters a session 
record automatically. 


Provided neitner the terminal or its line are held, the site 
controller is able to initiate log-on procedures as soon as the 
physical path to the terminal is established. 


- General purpose terminals are logged-on as soon as the 
physical path between the site controller and the terminal 
is established. 


- Controlled terminals are logged-on for general purpose, 
providing there is account time available. The user 
identification is assumed to be the terminal 
identification. 


~- Dedicated terminals are logged-on as soon as their 
application is active. 
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At this stage if the procedure has been successful the following 
message is displayed: 


CC33 terminal-=name LOGGED 


Tha termina] q Tanannarl an fein a jon eS allaande? Fn eo ae ee oe) 
414109 LOoLingbiaqdg 25 now LUOQYCU ailu is awaitin wy Gil ALLYUCAaALILIVII request 
from an application before it is considered active. 

Manua = 


If the AUTO parameter was not used in a terminals description at 
network generation the operator must. issue a request to log-on. 
Depending on the line and terminal type there are three ways to 
request to log-on, providing the terminal and line are not held. 


1. If the terminal is attached to a switched line, the 
Operator must dial the ring indicator. When the site 
controller detects the ring indicator it will then start 
the log-on dialog (see below). 


2. If the terminal is equipped with a break key (and is not 
on a.switched line), the operator depresses this key, 
which causes the site controller to begin the log-on 
dialog ‘see below). 


3. if there is no break key, the operator must simulate the 
break signal by issuing the BRK command (see Section 
IV)3 this will then cause the site controller to begin 
the log-on dialog. 


NOTE % When a session is established, a break signal is no longer 
Significant except as an interrupt signal when specifically 
defined for that purpose at network generation. 


Log-on of a Dedicated Terminal 


A terminal can be dedicated to a specific application at network 
generation and the network control operator can also declare a 
terminal as dedicated by use of a privileged command. If automatic 
log-on is in effect, the session is established as described under 
Automatic Log-on above. If the terminal is described as manual then 
the operator must follow the procedure shown under Manual Log-on. 
Note that dedicated terminals can also be controlled. 
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Log-on of a Controlled Terminal 


If a terminal is described as controlled at network generation the 
operator must provide additional information during a manual log-on 
(see below). This information takes the form of user 

identi fication, project name, billing name and password which is 
associated to an account. The account will have been allocated an 
amount of time during which it can be connected to the computer, if 
there is no time credited to the account then the log-on request 
will be denied, this is also true if any of the other information 
required is incorrect. Automatic log-on has already been described 
above. Note that controlled terminals can also be dedicated. 


LOG-ON DIALOG 


Messages issued by the site controller are preceded by a four 
character identifier, sometimes preceded by an asterisk (*) which 
indicates that operator action is expected or required. The meanings 
of the messages are described in Section IV. 


Given that the operator has already conveyed a log-on request to the 
site cantroller, the following message(s) can be displayed asking 
for log-on information. 


*  ccoo [10] [APPL 2] (1) 
*  CCOl [10,] USER/PROJECT/BILLING | $PASSHORD] [ APPL | > (44) 
*  CCO2 PASSWORD ? (144) 


(i) This question is asked for general purpose and dedicated 
terminals without the control option. If the terminal is 
not on a switched line the ID (terminal identifier) is 
not asked for. If the terminal is dedicated the APPL 
(application) is not asked for. Thus if both the 
preceding conditions apply, no message is displayed. 


(ii) This question is asked for controlled terminals whether 
they are dedicated or not. As for (i) above IND and APPL 
may not be asked for, but USER is mandatory: for some 
sites PROJECT and BILLING (account name) are generated 
automatically from the user identifier, however if they 
are not, then they have to be supplied. For some sites 
the user identifier is associated with a list of 
applications that may be used’ if the terminal is not 
dedicated and the APPL field is not completed, then the 
application is assumed to be the first application in 
the list associated with the user. If PASSWORD is not 
asked for it will be requected in question CCO2. 
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(iii) This question is asked only after question CCO! when 
PASSWORD was not shown. This is for reasons of site 
security when this password is to be kept secret. There 
are two mechanisms for. this either the password is not 
printed when the operator enters it,or it is overwritten 


with other characters so that it is illegible. 


The operator should enter the required information after each 
question. 


If any of the responses are unacceptable the log-on request is 
denied and the following message is displayed: 


CC04 LOGON DENIED reasons 
NOTE s This message does not necessarily mean an error in the 
response, the reasons may show that there is no time credited 
to an account, the application is not active or is already 


supporting the maximum number of terminals (see messages in 
Section V). 


If all the responses have been acceptable but: 


- no application has been specified (for non-dedicated 


terminals) 
or 
—- the terminal does not have an enabled terminal queue (MAM 
applications) 
or 


- the application (TDS subsystem) has not yet issued an 
allocation request for the terminal 


then the terminal is in the LOGGED state and is waiting to be 
activated. This is indicated by the following message: 


CC33 terminal-name LOGGED 
The terminal will be activated: 
- in VCAM mode - to the first TDS application that requests 
it, if the terminal is dedicated then only 
to that application. 


- in MAM mode — when the associated terminal queue Is 
enabled. 
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When a Session is established the following message is displayed: 
nhemm terminal-name ACTIVATED FOR application ON mm.dd.yy 
- If the application is shown, the terminal is in session in 
either two way alternate (TWA), or one way input (OW!) 
mode with one of the following applications: 
- a program queue (OWI) for MCS COBOL 


- a program and a terminal queue for MCS COBOL 


TOF 


ROF 
- TDS 


- If the application is not shown, the terminal is in 
session in one way output (OW0O) mode with its associated 
terminal queue. To be in this mode the operator must not 
fill the APPL field during log-ons a dedicated terminal 
cannot be used in this mode. 


SESSION TERMINATION 


A session can be terminated for any of the following reasons! 


- use of the DIS command by the terminal operator 
(logging-off ) 


~- network control operator intervention 
- program (application) request 
—- external factors (i.e. hardware failure) 


When a session is terminated, a general purpose terminal is eligible 
to log~on to another application. 


For switched point-to-point lines, when the DIS command is used with 
the HOLD option, the terminal is logged-off from the application but 
the line is not disconnected: also if there is no activity over the 
line for a specified time period the line is disconnected and the 
Session is terminated. 


NOTE8 [OF and TDS applications have a separate command for 
logging-offs: it is - BYE for TDS and - QUIT for IOFs the DIS 
command should not be used with either of these applications 
(see the relevant manuals for IOF and TNS). 
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SECTION IV 


OPERATOR COMMANDS 


The terminal operator is provided with a set of eight commands. 
These commands and their functions are described in this section. 


The following is a list of the commands and a brief description of 
their functions, each command is dealt with in detail on the 
following pages.It should be noted that applications have their own 
commands and that the commands in this section relate only to BINS 
functions. For this reason they relate more to MCS usage than VCAM 


based applications. 


Command 


Break (BRK) 


Broadcast Telecom(BT) 


Disconnect (DIS) 


Display Telecom (DT) 


Halt Message (HM) 


Modify Terminal Edit (MTE) 


Ready (RDY) 


Function 


Simulates the function of the BREAK 
key for terminals that do not have 
this feature. 


Sends a message to other terminals, 
network control terminal or system 
console. 


Logs-off, i.e. causes the session to 
terminate. 


Displays the state of the terminal 
or its queue. 


Suspends the delivery of messages to 
the terminal (if connected to a 
program queue). 


Modi fies the way in which the 
terminal formats data. 


Used after 8 page or message 
over flow to indicate that the 
terminal is ready to resume 
activity. 
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Resume Message (RM) Resumes the delivery of messages to 
the terminal after an HM has been 
used. 


NOTE The following rule applies to ali commands. 


Each message must be preceded by a break qualifier (three 
characters) that indicates to the site controller that the entry is 
a command. The break qualifier can be specified at network 
generations if it is not, the following default value is used - $*S$, 
The default value ($*$) is shown in all the following commands: if 
howeVer your site has its own break qualifier this should be 
substituted when any commands are used. 


Where “Possible site controller replies" are shown on the following 
pages these should be referred to Section V for interpretation. 


Where a delta (4) is shown in a command this indicates that a snace 
is mandatory in this position for correct command format. 
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Break (BRK) Command 


Functions 

Sends a break signal to the site controller or an application, 
Formats 

$*SBRK 

Meaning: 

If the terminal is IDLE then a log-on dialog is: initiated. 

If the terminal is connected to an application (VCAM subsystem or 
program queue). for which the BREAK parameter was specified at 
network generation, the break signal is sent to the application or 
the queue, otherwise it is ignored. 
In addition, for VIP type terminals the BRK command also executes 
the function of the RDY command. Thus the BRK will have the effect 
of RDY+BRK. 

Possible site controller replies: 
* CCOl CID,J CAPPL] 


* CCO02 {(ID,] USER/PROJECT/ACCOUNT [CSPASSWORD] (,APPL] 
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Broadcast Telecom (BT) Command 


Functions 

Sends a message to the specified terminal. 

Formats 

$*SBT Aterminal~name A message-text 

Meanings 

The message is sent to the terminal specified, if OPER is used for 
terminal-name the message is sent to the network control terminal, 
if MAIN is used the message is sent to the system console. 

The message text must not exceed !28 characters including spaces, 
otherwise the message will be truncated. The message must begin with 


a non~alphabetic character or a word of more than 4 characters. 


The destination terminal must be active, not subject to a HM command 
and must not be a slave. 


Possible site controller replies: 


COMPLETED 
INVALID STATUS 

CCO03 BT INVALID NAME 
UNAUTHORIZED COMMAND 
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Disconnect (DIS) Command 


Functions 


Terminates a session between the terminal and application, i.e. 
log-off. 


Formats 
HOLD 
easDI5| 4 
STRONG 
Meaning 


The session is terminated and the terminal is returned to the IDLE 
state. If it was specified at network generation (defined with the 
BREAK option>, direct access applications (VCAM subsystems) and 
program queues are informed of the disconnection. 


The HOLD parameter is only used for terminals that have a ; 
point-to-point switched line, the use of this. option ensures that 
the line is not disabled so that it can log-on to another 
application without dialing the ring indicator’ all the operator has 
to do is press the break key or issue a break (BRK) command. 


The STRONG parameter is only used for terminals that have a 
multipoint switched line, the use of this option ensures that the 
line is disabled. If the option is not used then only the issuing 
terminal is disconnected. 

Possible site controller replies: 


hhemm terminal-name DEACTIVATED BY USER 
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Display Telecom (DT) Command 


Functions 


Provides the terminal operator with information about the terminal 
Or a queue. 


Formats 
STRONG 
$xSDT E QUEUE | 
program-queue-name 
Meaning: 


The following information concerning the terminal is provided: the 
terminal’s name, state and current session. 


If the STRONG option is used the following information is also 
providedt the current data formats used, the input/output 
capability, alternate states (if present), statistical information 
and the current state of the terminal queue with the number of 
messages it contains (if applicable). 


If the QUEUE option is used, information is given for the terminal 
queue but not for the terminal. The following information is given 
for the queue? its state, the number of messages it contains, and 
the percentage of queue space used. 

If a program queue name is specified, the following information 
concerning the queue is supplied: the queue name, its state, number 
of messages it contains, and the percentage of queue space used. 
Possible site controller replies: 


The following messages can be displayed? CCO08,CC09,CCIO and CCI5. 
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Halt Message (HM) Command 


Functions 

Suspends the delivery of messages to the terminal. 
Format 

$*SHM 

Meaning: 


The terminal is incapable of receiving any messages until the RM 
command is used. 


Possible site controller replies: 
ConPLETED | 


cc03 HM COMPLETED 
RETRY LATER 
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Modify Terminal Editing (MTE) 


Functions 


Modifies the presentation and format of data received and 
transmitted by the terminal when it is connected to a program queue. 


Formats 
INORM 
BLOCK line-length) (block-size [(ONORM 
S$*SMTE | | * * IMAR 
(NBLOCK ONE DT 
INEDT] ~ 
Meaning’ 


This command can only be used if the terminal is not in session with 
an application. 


BLOCK - indicates that message blocking should be used. 


NBLOCK =~ indicates that message blocking should not be used. 


line~length - an integer value (range 4 to 1000) that 
specifies the maximum number of characters 
(including spaces) that will constitute a line. 
If the present value is to be used this is 
indicated by an asterisk (*). 


block-size - an integer value that specifies the maximum 
number of lines per message (block). If the 
present value is to be used this is indicated 
by an asterisk (*). This value multiplied by 
the line length gives the maximum message 
length that can be received or transmitted by 
the terminal.If the maximum message length is 
exceeded the message will be truncated: see the 
table in the previous section. 


INORM ~ specifies normal input’ message headers and trailers 
(if any) are deleted, all control characters are 
deleted, all other characters are shown unaltered, 
including standard mark, the repeat function is 
per formed. 


INEDT - specifies unedited input’ all characters are shown 
unaltered. 


IMARK = specifies input mark’ all hexadecimal control 
characters are translated into standard marks, all 
other characters are shown unaltered, the repeat 
function is per formed. 
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QNORM - specifies normal output’ message headers and trailers 
are provided by the system (except for VIP type 
terminals where the text must be preceded by certain 
characters) where needed, control characters are 
translated into the appropriate code, standard marks 
are translated into hexadecimal, other characters are 
transmitted without alteration, the repeat function 
is performed. 


ONEDT - specifies unedited output’ all characters (including 
control] characters) are transmitted without 
alteration, message trailers are provided by the 
system if required, for VIP type terminals the user 
can precede the message with a header if required. 


Possible site controller replies: 
CC22. MIE  INV./MEANINGLESS PARAM. :{ BLOCK] [NBLOCK] [LENGTH ] 


INVALID NAME 
INVALID COMMAND 
CCO3 MIE )COMPLETED 
INVALID SYNTAX 
\ INVALID STATUS ; 


NOTE: This command should be used with caution as the wrong data 
formats could cause the MCS application to abort. In general 
this command should only be used when the operator has been 
instructed to do so. 


4-09 


Ready (RDY) Command 


Functions 

Corrects a “busy" condition on a VIP type terminal. 

Format 

$*$RDY [a STRONG | 

Meaning’ 

After a page overflow on a VIP type terminal the terminal is 
considered as being “busy". This command informs the application 
that the condition has been rectified.If the STRONG option is used 
the message that caused the overflow is cancelled, otherwise the 
message is retried and will possibly cause a recurrence of the 
"busy" condition. 

Possible site controller replies: 


None. 
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Resume Message (RM) Command 


Functions 


Resumes the delivery of one or more messages to the terminal, 
normally only used after an HM command has been used. 


Format & 
s«sRM[ OALL | 
Meaning: 


If the ALL option is used, the delivery of messages is resumed. If 
however the option is not used, only one message will be allowed 
before a halt message state is resumed. Note that after an HM 
command, entering an asterisk (*) will have the same effect as $*$RM 
and will allow just one message to be delivered at one time. This is 
of use when the operator wishes to deal with only one message at a 
time. 


Possible site controller replies: 


{ COMPLETED } 


CCO3. so RM 
MEANINGLESS 
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TERMINAL MESSAGES 


Terminal messages can be divided into two general types’ those which 
are entered by the terminal operator (Input Messages) and those 
received by the terminal from or via the site controller (Output 
Messages). 


INPUT MESSAGES 


An input message can be one of the followings 


-~ A reply to a site controller message (i.e. the Eesponses in 
a log-on dialog). 


- An operator command (see Section IV). 
~ A data message (to an application, these are user defined). 
Whatever the type, the operator enters a message according to a 


specified format, the message must then be terminated with the 
appropriate characters and transmission requested (see Section II). 


QUTPUT -MESSAGES 


An output message can be one of the following: 
- A message sent from another terminal (see Section IV). 
~- A message sent by the application (user defined). 
- A message from the site controller: 
- that does not require a reply 


~ that requires a reply (as indicated by a preceding 
asterisk (*). 
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Site Controller Messages 


The remainder of this section is devoted to site controller 
messages, their format, meaning and any required actions. As 
previously stated, if a message is preceded by an asterisk (*), it 
indicates that an operator reply is expected. This reply must be 
made before activity can be resumed. 


Messages can be preceded by either a time stamp (hh.mm) or a key 
CCnn)s time stamp messages are listed first in alphabetic order, 
those with a key are listed in ascending order of the numeric part 
of the key. 


Hhh.mm term-name message-text 


Meanings the message is the result of the use of a BT command on the 
terminal showns if term-name is OPER the message is from 
the network control operator, if it is MAIN it is from the 
system operator. 


Action: respond to the message if required, otherwise none. 
hh.mm term-name ACTIVATED [FOR appl-name] ON mm.dd.yy 


Meaning’ the terminal is now in active session with the application 
shown, if no application is shown the session is with the 
terminal’s terminal queue (echo mode via MCS). 


Actions: the terminal can now be used. 


USER 
hhemm term-name DEACTIVATED BY QPERATOR 

SYSTEM 

APPL 


Meaning? the current session has been terminated by: 


- APPL = application 

~- SYSTEM = the communications system 

QPERATOR = the network control operator 

USER = the terminal operator (use of the DIS command). 


Action? none. 


* ¢CCoo ID? 


Meaning: log-on dialog request to a non-controlled dedicated 
terminal on a switched line. 


Action: enter the terminal’s identifier (up to 4 alphanumeric 
characters, the first character must be alphabetic). 
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* COO [ID,] APPL ? 


Meaning: 


Actions 


log-on dialog request to a non-controlled general purpose 
terminal. If ID is shown the terminal is on a switched | 
line. | 


enter the terminal identifier (if required) and the 
application identifier. Each field can be up to 4 
alphanumeric characters, for each field the first character 
must be alphabetic. 


* (CO! [ID,] USER/PROJECT/BILLING[$PASSWORD]f APPL] 2 


Meanings 


Action: 


* CCO2 


Meanings 


log-on dialog request to a controlled terminal: If ID is 
shown, the terminal is on a switched line: this is a 
request for the terminal identifier. PROJECT is a request 
for the project name and BILLING is a request for the 
billing names these two requests may not need a reply as 
this information can be generated from the user identifier 
which its requested by USER’ this request must be answered. 
SPASSWORD, if shown, is a request for the password 
associated with the terminal and the application to be 
used’ if this field is not shown, questian CCO2 will be 
asked when CCO! has been answered to. APPL is a request for 
the application name and indicates that the terminal is 
general purpose: if this field is not shown, this indicates 
that the terminal is dedicated. 


reply with the requested information. The fields should be 
Separated with the same characters as in the question 
({.e., ~ 7 ~ $), and be supplied in the same order. The ID 
and APPL fields can be up to 4 alphanumeric characters but 
both fields must begin with an alphabetic character. The 
other fields can be up to 8 alphanumeric characters in 
length. 


PASSWORD ?[XXXXXXXX] 


request for the password associated with the terminal and 
the application. This question is only asked after question 
CCO!| (where this field was not shown), and is for reasons 
of site security. On some terminals the operator reply is 
not physically printed and on others the reply field is 
masked with other characters (XXXXXXXX) so that the 
password cannot be read by another person. This case only 
applies to terminals with a hard copy. 


Action: reply with the correct password. The reply can be up to 8 


alphanumeric characters. 


CLCU3 command-name 


COMPLETED (i) 


INVALID COMMAND (ii) 
INVALID NAME (iil) 
INVALID STATUS (iv) 
INVALID SYNTAX (v) 
MEANINGLESS (vi) 
RETRY LATER (vil) 
UNAUTHORIZED COMMAND (vill) 
QUEUE SEND ERROR RC = (ix) 


XXXXXXXX —— VYYYYYY, NAnnnn 


Meanings site controller response to the use of the command shown 
and indicates thats 


(1) 
(ii) 
(iii) 
(iv) 
(v) 
(vid 
(vii) 
(viii) 


(ix) 


Actions 


(viii) 
(ix) 


The command has been successfully completed. 
An invalid command was entered. 

The main object name in the command is wrong 
(i.e. the terminal name in a BI command). 
The destination of a BT command is inactive. 
The wrong syntax was used for the command. 
The command is meaningless (i.e. entering an 
HM command while the terminal is still 
subject to a previous HM command). 

The command cannot be accepted as a previous 
command has not yet been completed. 

The terminal operator has entered a 
privileged command. 

An error has been detected while trying to 
transmit a message to a queue. 


None. 

Verify the command syntax and re-enter the 
command. 

Verify the main object name (using DT 
command) and re-enter the command. 

Re-enter the command when the destination is 
able to receive. 

As for (ii). 

None. 

Re-enter the command later, after the 
current command has been completed. 

None. 

Verify that the error is not due to a queue 
overflow (use DT command). If it is, retry 
later when the queue is not full otherwise 
inform the Field Engineers. 
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CCO4 LOGON DENIED 


appl-name INACTIVE (1) 

user-id ALREADY LOGGED (11) 
(iii) 

user-id 

password 

account~name INVALID (iv) 


project-name 

appl=-name 

appl-name NOT AUTHORIZED 
appl-name TRY LATER . (vid 
appl-name UNAVAILABLE (vil) 
appl-name CONTROL MANDATORY (viii) 


password NOT CREDITED | 
\ 


a 


Meaning: the site controller has denied a log-on request for the 
; following reasons? 


et) 


(ii) 


(iii) 


(iv) 
(v) 


(vi) 


(vii) 


(viil) 


Action? (i) 
(ii) 

(iii) 

(iv) 

(v) 


(v1) 
(vii) 
(viii) 


The application requested is not active or the 
program queue is disabled. 

Someone with the same user identifier is 
already logged, user identifiers should be 
unique. 

The account associated with the password has no 
time credited to it. 

The indicated log-on parameter is incorrect. 
The remote end user is not authorized to use 
the requested application. 

The site controller has been unable to start an 
application such as IOF or ROF. 

The site controller has heen unable to 
establish a session with an application, this 
could be because the maximum number of sessions 
permissible for that application have already 
been established. 

The log-on request was to an application for 
which control is mandatory, this option has not 
been specified for the terminal at network 
generation (i.e. the terminal must be 
controlled and have the correct password). 


Inform network control operator. 

As for (i). 

Inform the site administrator. 

Log-on again using the correct parameters. 
Inform the network control operator or the site 
administrator. 

Try logginy-on again later, if the message is 
persistent inform the Field Engineers. 

Try logginyg-on again later, if message is 
repeated inform the network. control operator. 
Inform the network control operator. A new 
network generation is needed to specify the 
terminal with the necessary control option for 
this application. 


5-05 


appl-name 
CCO8 term-name ACTIVE [For } | 20") [usteser23] (i) 
queue-name Pl +t - 


(ii) 


HELD) app l-name 
CCO8 term-name ASG TO | 
IDLE 


queue-name 
LOGGED appl-name 
CCO8 term-name ON } ][ustuser-14] (iil) 


LOGGING queue~name 


Meaning? these messages are a response to a DT command without the 
STRONG or queue name options. One of the three messages is 
displayed depending upon which state the terminal is in. 


(i) The terminal is active and in session withs 
- an application or a program queue (only if the 
first optional field is present) 
or 
- with its terminal queue (only if the third 
optional field is present) in which case the 
user identifier is shown. 


NOTE: the first and third optional fields 
are mutually exclusive. 


If the "/TEMP® field is shown the terminal 
is only temporarily assigned to the 
application or queue. 


(ii) The terminal is dedicated (ASG TO) the 
application or program or terminal queue shown. 


The terminal is either in the IDLE state or in 
the HELD state, in which case it is subject to a 
HT command. 


(iii) The terminal is either LOGGED or is LOGIN on to’ 
- an application or a program queue (only if the 
first optional field is present) 
or 
- its terminal queue (only if the second 
optional field is shown), in which case the 
user identifier is shown. 


NOTE: The two optional fields in this message 
are mutually exclusive. 


Actions in all three cases none. 
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NBLOCK 


WF 
BLOCK 
9 ni/n2 IN = QU = N [ ALT 
\ ! 


* 


ON 
‘queue-name| 
OFF 


U 
\u/ 


Meaning? this message is a response to a DI STRONG command. 


BLOCK 


NBLOCK 


ni/n2 


IN = 


OU = 


HM 


TH 


ALT 


Action: none. 


indicates that messages are blocked and the ni/n2 
field is meaningful. 


indicates that the messages are unblocked and 
therefore the nl/n2 field is meaningless. 


indicates the blocking factor, nl is the maximum 
line length and n2 is the maximum number of lines 
per message (block): these two factors multiplied 
together will give the current maximum message 
size. 


this field indicates the mode of input, M = mark 
mode, N = normal mode, U = unedited mode, an 
asterisk (*) indicates that the field is 
meaningless as the terminal is being used for 
output only. 


this field indicates the mode of output, N = 
normal, U = unedited, and an asterisk (*) indicates 
that the field is meaningless as the terminal is 
being used for input only. 


if this field is present it indicates a HM command 
is in force, the terminal cannot receive any 
messages (output suspended). 


if this field is present it indicates that the 
terminal cannot send any messages (input 
suspended). 


this field is only present if the network control 
operator has used an MIT command on the terminal or 
its terminal queue and the command is still in 
force. This privileged command allows a terminal to 
use another terminal’s terminal queues the terminal 
whose queue is being used (by another terminal) can 
only operate in input mode. 

If ALT ON is shown, this indicates that the 
terminal is using the terminal queue shown (another 
terminal’s queue). 

If ALT OFF is shown, this indicates that the 
terminal is using the terminal queue shown (this 
terminal’s queue). 
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OQ 


CC10 
queue~name 


| [ HELD ] nl MSG(S) n2 % OF FREE SPACE 


Meaning: this message is a response to a DTI command where a queue 
name was specified, or if 0Q (output queue) is shown it is 
a response to a DT STRONG or DT QUEUE command and is 
referring to the terminal’s queue. 
If HELD is shown it means that the queue is disabled. 
ni - is the number of messages in the queue. 
n2 ~- is the percentage of free space in the queue. 


Action? none. 


CCI9 term-name [No7] ON STAND BY IN 
Meaning! this message is displayed when an MCS COBOL program enables 
or disables its program queue. The message is only sent to 
a terminal which is in session with the queue. 


If NOT is shown the queue is enabled, otherwise the queue 
is disabled. 


Action? none. 
CC22 MIE INV./MEANINGLESS PARAM.: [BLOCK] (€NBLOCK) [LENGTH] 
Meaning: response to an MTE command where an invalid or meaningless 
parameter has been supplied. The parameters in question are 


shown, 


Actions validate the parameters to be used and re-enter the command. 


CC33 term-name LOGGED 
Meaning: this message indicates that the terminal has been 
successfully logged but is waiting for an application to 
issue an allocation request for the terminal. 


Action? none. 
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